PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Appearance Manager >

Programming With the Appearance Manager

BeginThemeDragSound

Continuously plays a theme-specific sound associated with the user's movement of a given interface object.

pascal OSStatus BeginThemeDragSound (
                     ThemeDragSoundKind kind);
kind
A value of type ThemeDragSoundKind . Pass a constant specifying the sound to play; see Theme Drag Sound Constants for descriptions of possible values.
function result
A result code; see Result Codes .
DISCUSSION

The Appearance Manager automatically plays drag sounds for standard user interface elements and for Drag Manager drag actions. Your application may call BeginThemeDragSound , typically upon detecting a drag initiation, to play a drag sound for a custom element. BeginThemeDragSound plays the specified sound in a continuous loop until your application calls the function EndThemeDragSound , typically upon receiving a mouse-up event.

Note that the BeginThemeDragSound function automatically tracks the current mouse position and handles any panning or variations in pitch for the sound.

VERSION NOTES

Available with Appearance Manager 1.1 and later.

© 1999 Apple Computer, Inc. – (Last Updated 29 April 99)